home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / both360.arc / BOTH360.DOC < prev    next >
Text File  |  1990-11-11  |  14KB  |  426 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                            BOTH.EXE(tm)
  12.  
  13.                            Release 3.60
  14.  
  15.                            May 8, 1990
  16.  
  17.              Copyright (c) 1990 by Peter F. Feldmann
  18.                        All Rights Reserved
  19.  
  20.  
  21.          ---------------------------------------------------
  22.          Limited permission is  granted to individual  users
  23.          to evaluate this program  for a thirty day  period.
  24.          Following this period, a fee of $20 must be sent to
  25.          I.C. Consultants  to register  the user's  copy for
  26.          private, non-commercial use.
  27.  
  28.          Business  or  commercial  users,  please contact IC
  29.          Consultants for licensing information.
  30.  
  31.          This program may be distributed free of charge to
  32.          other private  users for  evaluation, provided  the
  33.          files remain unaltered in their original  distribu-
  34.          tion "package" (BOTH360.EXE or BTH360.EXE).
  35.  
  36.          All other rights are explicitly reserved by the
  37.          author.
  38.          ---------------------------------------------------
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  BOTH 3.60         Documentation         Page 2/9
  45.  
  46.  
  47.                         HOW BOTH OPERATES
  48.  
  49.  
  50.  BOTH(tm) prints ASCII text files to both sides of the page in
  51.  "book" or "magazine" style.  BOTH does this by scanning the
  52.  specified input file, then helps the user make decisions on
  53.  specific page formats, etc.  The file is printed as alternate
  54.  pages (eg. odd side first, 1, 3, 5, 7, . . .).  Once one side
  55.  has been completed, reverse the paper and re-insert it into the
  56.  printer to print the other side (eg. 2, 4, 6, . . .).
  57.  
  58.  Laser Jet Printer Users:  BOTH will work most efficiently if
  59.  you print the even-numbered pages first, then turn and load the
  60.  pages into the sheet feeder to print the odd-numbered pages
  61.  last.
  62.  
  63.  Limited text formatting commands are included, but the user
  64.  must assume responsibility to preset the printer with the cor-
  65.  rect formatting controls (ie., choice of font or type style,
  66.  number of lines per page, characters per line, etc. etc.)  If
  67.  you are a registered user, see the SETUP.EXE file on your dis-
  68.  tribution diskette for a way to send control codes to your
  69.  printer without exiting BOTH.
  70.  
  71.  
  72.  USAGE - At the DOS prompt, type:
  73.  
  74.          BOTH [[[D:]pathname\]filename.ext]  <ENTER>
  75.  
  76.  If no filename is specified, BOTH prompts the user for a file
  77.  to be printed.  ADVANCED USER NOTE:  Wildcard file specifiers
  78.  cannot be used directly, though a GROUP.BAT file which uses
  79.  BOTH to print a group of specified files is included on the
  80.  BOTH360 distribution diskette, which is provided to all regis-
  81.  tered users.
  82.  
  83.  Once a file is selected, BOTH scans the entire file, searching
  84.  for the widest line, the number of lines in the file, and
  85.  checking for the presence of form feed characters in the text.
  86.  The text file's "statistics" are displayed near the top of the
  87.  screen for reference as shown on page 3.
  88.  
  89.  
  90.  
  91.  
  92.  BOTH 3.60         Documentation         Page 3/9
  93.  
  94.  
  95.  +-------------------------------------------------------------+
  96.  |The file: TESTFILE.DOC contains 344 lines.                   |
  97.  +-------------------------------------------------------------+
  98.  |The widest line is: 70   characters wide.  Suggest: ELITE    |
  99.  |6 Form feeds found in text, assuming file is pre-formatted   |
  100.  |The maximum number of lines per page is: 57                  |
  101.  +-------------------------------------------------------------+
  102.  
  103.                      Fig. 1  -  File "Statistics"
  104.  
  105.  
  106.  The display includes the length of the file examined in lines,
  107.  the width of the widest line, and the suggested printer font to
  108.  be used (in this case, ELITE).  If you are a registered user,
  109.  you will find a program called SETUP.EXE on your distribution
  110.  disk.  SETUP, provided free of charge, is a TSR which can send
  111.  printer control strings to the printer while you are in the
  112.  BOTH program.  This will enable you to reconfigure your printer
  113.  depending on what information BOTH gives you after scanning
  114.  your file.
  115.  
  116.  NOTE:  *If*  BOTH encounters form feed characters in your file,
  117.  it will indicate their number as shown in Fig. 1.  The maximum
  118.  number of lines per page (using the form feeds) is also shown.
  119.  If there are more than 60 lines per page, you can be fairly
  120.  sure that the text file you are scanning with BOTH has been
  121.  altered or corrupted in some way, and will need some editing
  122.  before being printed.  For example, you may wish to remove all
  123.  form feeds and use BOTH's built-in automatic formatting feature
  124.  to print the file.
  125.  
  126.  
  127.  
  128.  
  129.  BOTH 3.60         Documentation         Page 4/9
  130.  
  131.  
  132.  
  133.                       FILE   CONFIGURATION
  134.  
  135.  The following input helps BOTH determine the necessary informa-
  136.  tion to print text files correctly to BOTH sides of a page.
  137.  Default settings are shown in CAPS inside the brackets [].
  138.  
  139.  
  140.  "Prepare to Print File [Y/n] ?"
  141.  
  142.  If "N" is entered, BOTH discards the current file and prompts
  143.  the user for another filename for possible printing.
  144.  
  145.  
  146.  "Print [60] lines/page ?"
  147.  
  148.  If BOTH finds no form feeds in the file, the first question in
  149.  the configuration menu asks how many lines of text per page are
  150.  to be printed (60 is the default value).   If the file has been
  151.  pre-formatted with blank lines (so that there are 66 lines/page
  152.  on a standard sheet), be sure to specify the exact number of
  153.  lines which totally fill one page (at 6 lines/inch, a sheet 11
  154.  inches long would be filled with 66 lines), and answer NO to
  155.  the "AutoFormat" prompt below.
  156.  
  157.  LASER-JET USER'S NOTE: When using a Laser-Jet(tm) type printer,
  158.  be sure that the printer's number of lines per page menu set-
  159.  ting is at least two or three lines more than the total page
  160.  length specified to BOTH.  If this is NOT done, extra page
  161.  feeds will result.  Check that the Laserjet's menu has been set
  162.  to lock in the desired typeface.
  163.  
  164.  
  165.  "Begin at page [1]?"
  166.  
  167.  Specify the beginning page number to print.
  168.  
  169.  
  170.  "End at page [nn]?"
  171.  
  172.  BOTH automatically calculates the number of pages it will take
  173.  to print the complete file at the number of lines per page rate
  174.  you specified.  To end at an earlier page, just type in its
  175.  number.
  176.  
  177.  
  178.  "Print Odd or Even pages first? [O/e]"
  179.  
  180.  "O" will print the odd pages of the file (ie., 1, 3, 5, . . .
  181.  etc.)
  182.  
  183.  
  184.  BOTH 3.60         Documentation         Page 5/9
  185.  
  186.  
  187.  "Pause after each page? [y/N]"
  188.  
  189.  If "Y" is chosen, BOTH will pause after sending each page to
  190.  the printer.   The user may either continue or halt the print
  191.  operation. This feature is useful if you're using a single
  192.  sheet printer or just experimenting with the format of a page.
  193.  
  194.  
  195.  "AutoFormat pages? [Y/n]"
  196.  
  197.  BOTH has limited capabilities to lay out "raw" text files (eg.,
  198.  source code) into reasonably formatted pages.  The "AutoFormat"
  199.  feature subtracts two lines from each page: the first is used
  200.  as a blank line, the second contains the filename, date, and
  201.  page number of the file being printed.  Because two lines are
  202.  effectively removed from each page to implement this feature,
  203.  the "AutoF" number given at the top of the screen may be a
  204.  little larger than that given for pre-formatted text files.
  205.  
  206.  NOTE: (1) BOTH also adds extra spaces (see BINDING, below) on
  207.  the left margin of odd numbered pages for binding purposes.
  208.  Even numbered pages are unaffected.  (2) If form feed charac-
  209.  ters are found in the text file, BOTH assumes the file is al-
  210.  ready correctly formatted and does not offer this prompt to the
  211.  user.
  212.  
  213.  
  214.  "Add line numbers to listing? [y/N]"
  215.  
  216.  A simple line numbering feature in the format: "nnnn>" (adding
  217.  five characters to the width of each text line) is available
  218.  here for those interested in printing source code, etc.
  219.  
  220.  
  221.  "Use how many spaces for binding? [3]"
  222.  
  223.  BOTH can automatically add a number of spaces to the left
  224.  margin of odd-numbered pages to allow for binding holes, etc.
  225.  Three spaces is the default value, but the user may wish to ad-
  226.  just this value as needed, or to remove binding space
  227.  altogether by entering "0".  Be sure to remember that this
  228.  binding space is ADDED (on odd pages only) to any left margin
  229.  space requested.  NOTE: The variable binding space option has
  230.  been added to 3.60 while the 80 character truncate function has
  231.  been removed.
  232.  
  233.  
  234.  
  235.  
  236.  BOTH 3.60         Documentation         Page 6/9
  237.  
  238.  
  239.  "Send output to LPTx ???? [1]"
  240.  
  241.  BOTH needs to know which printer port (LPT1, LPT2, or LPT3) to
  242.  use for its output.  Type in the number 1, 2, or 3 to specify
  243.  the port.  If [ENTER] is pressed, BOTH will default to LPT1.
  244.  
  245.  
  246.  "Specify Left Margin Space [0]"
  247.  
  248.  BOTH can generate a left margin space of "n" characters if you
  249.  so desire.  These spaces are in addition to the spaces reserved
  250.  for binding purposes as explained above.  Type in the number of
  251.  characters you wish added.   Extra-narrow files are centered on
  252.  the page.
  253.  
  254.  
  255.  "Print other side ... ? [y/N]"
  256.  
  257.  Once one side has been printed, BOTH prompts the user, asking
  258.  if the other side of the current file is to be processed.  If
  259.  the user types a "Y", the second side will be sent to the
  260.  printer, keeping all user-supplied parameters exactly the same
  261.  as for the first side printed (ie., the same page size, begin-
  262.  ning page, ending page, left margin, etc.).  To change any pa-
  263.  rameters, type "N" to this prompt, which will bring up the fol-
  264.  lowing query:
  265.  
  266.  
  267.  "More Files to Print ?  [a/y/N]"
  268.  
  269.  If the user types "A" (Again), the same file will be readied
  270.  for printing, but the user is prompted for new starting and
  271.  ending pages, etc.  If "Y" is entered, the user will be
  272.  prompted for a new filename, otherwise BOTH will exit to DOS.
  273.  
  274.  
  275.                        MISCELLANEOUS NOTES
  276.  
  277.  BOTH is intended for use with "plain vanilla" ASCII text files,
  278.  such as source code and many documentation files (eg., ".DOC"
  279.  or ".TXT", such as the one you are now reading.)  While many
  280.  word processors embed an assortment of formatting characters
  281.  into their files, most can be made to create plain ASCII text
  282.  files by "printing to disk".  Unless originally written using
  283.  the non-document mode,  WordStar(tm) files will need to be
  284.  filtered of higher ASCII characters before being printed.
  285.  There are many such filter programs (such as WS2ASC.COM) avail-
  286.  able in the public domain.
  287.  
  288.  
  289.  
  290.  
  291.  BOTH 3.60         Documentation         Page 7/9
  292.  
  293.  
  294.  Another possibility is offered by the utility PRNDSK.COM, found
  295.  on the BOTH360 distribution disk.  It offers an easy way to
  296.  redirect printer output to a disk file, which itself can later
  297.  be sent to a printer, edited, etc.
  298.  
  299.  PROBLEM FILES:   Text files which have been specially treated
  300.  to double-print lines by omitting line feed characters (such as
  301.  the documentation for some versions of PROCOMM), or by includ-
  302.  ing embedded printer control characters, may have to be hand-
  303.  edited before using BOTH.  Files with embedded form feeds will
  304.  usually print acceptably using BOTH "as-is".  If problems are
  305.  encountered, try removing the offending characters before
  306.  printing the file.  Any line with an embedded form feed will be
  307.  processed to place the form feed at the end of that line, thus
  308.  keeping all characters in that line on the same page.  You may
  309.  wish to place form feeds on separate lines.
  310.  
  311.  ---------------------------------------------------------------
  312.  
  313.  
  314.  SPECIAL NOTE:  We'd suggest not attempting to print a 700 page
  315.  book with BOTH before giving it a test file or two (including
  316.  this .DOC file).  Any bug reports would be gratefully received.
  317.  Thanks to all those who contributed to the success of previous
  318.  versions of BOTH with comments, suggestions and donations, they
  319.  are much appreciated.
  320.  
  321.  
  322.  
  323.                         TECHNICAL SUPPORT
  324.  
  325.  Limited support is available to REGISTERED USERS of BOTH.
  326.  
  327.  The best way to contact us is by EMAIL on CompuServe
  328.  (75156,2535), BIX ("PFELDMANN"), MCIMail (248-9063), or on the
  329.  Santa Barbara PC Users Group BBS: (805) 682-6158.  Second best
  330.  is via U.S. Mail (be sure to enclose a stamped, addressed en-
  331.  velope for a reply).
  332.  
  333.  NOTE:  We cannot provide telephone support for this product,
  334.  nor can we provide BBS support for unregistered users . . .
  335.  sorry!
  336.  
  337.  ---------------------------------------------------------------
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  BOTH 3.60         Documentation         Page 8/9
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                           DISTRIBUTION
  355.  
  356.  Persons are encouraged to share and distribute copies of this
  357.  program free of charge, provided the distribution file
  358.  (BOTH360.EXE or BTH360.EXE) is kept intact, and that the files
  359.  contained therein are not altered in any way.  Persons who send
  360.  in payment of $20.00 or more will receive a registration dis-
  361.  kette with the latest BOTH update as soon as it becomes avail-
  362.  able.
  363.  
  364.  Commercial or multi-user licenses and custom versions to print
  365.  documentation files, etc. are available from I.C. Consultants
  366.  for a modest fee.
  367.  
  368.  ---------------------------------------------------------------
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  BOTH 3.60         Documentation         Page 9/9
  379.  
  380.  
  381.              ==========   I N V O I C E  ==========
  382.  
  383.  
  384.                          IC Consultants
  385.                           P.O. Box 902
  386.                      Santa Barbara, CA 93102
  387.                   BIX & MCIMAIL Name: PFELDMANN
  388.           Compuserve ID 75156,2535  **  MCI # 248-9063
  389.  
  390.  Name:
  391.  
  392.  Address:
  393.  
  394.  
  395.  
  396.  I enclose $_______________. Please register me as a user of
  397.  BOTH360.
  398.  
  399.  "Bug" Report:
  400.  I have encountered a problem using BOTH360.  The equipment I am
  401.  using includes:
  402.  
  403.  Computer:                       BOTH Serial #:
  404.                                  (see bottom of ending screen)
  405.  DOS version:
  406.  
  407.  Printer:            Word Procesor:
  408.  
  409.  Problem description:
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  I enclose a stamped, addressed envelope for your reply. (Registered
  423.  users can contact the author via MCI Mail, CompuServe, or on BIX
  424.  (Byte Information Exchange).
  425.  
  426.  "BOTH" is a Trademark of I.C. Consultants.